Greptile Summary

This PR adds a standalone workos.feature_flags module that exposes the full FeatureFlags API surface (list, get, enable, disable, add_target, remove_target) for both sync and async clients, and fills in three previously missing fields (tags, enabled, default_value) on the FeatureFlag model. It also consolidates the FeatureFlagsListResource type alias — previously duplicated in organizations.py and user_management.py — into a single canonical definition in the new module.

• src/workos/feature_flags.py: New module implementing all 6 endpoints via FeatureFlags (sync) and AsyncFeatureFlags (async), following the established SDK patterns exactly.
• src/workos/types/feature_flags/feature_flag.py: Adds tags: Sequence[str], enabled: bool, and default_value: Optional[Any] to the model — the last field uses Any which is permissive; worth narrowing if the API spec defines concrete value types.
• src/workos/organizations.py / user_management.py: Remove local duplicate FeatureFlagsListResource definitions and import from the new canonical source; existing FeatureFlag and FeatureFlagListFilters imports are still used in the scoped list methods.
• src/workos/client.py / async_client.py: Expose feature_flags property using the same lazy-initialization pattern as every other module.
• tests/test_feature_flags.py: Full coverage of all 6 endpoints for both sync and async variants; URL, HTTP method, and response shape are all verified.

Confidence Score: 5/5

• This PR is safe to merge — it's a clean additive feature with no breaking changes, consistent patterns, and full test coverage.
• All 6 new endpoints are implemented symmetrically for sync and async clients, following existing SDK conventions exactly. The type consolidation (FeatureFlagsListResource) is straightforward and verified to leave all existing imports intact. The two comments are non-blocking style suggestions (loose Any typing and lack of URL encoding for path params), neither of which affects current functional correctness.
• No files require special attention. feature_flag.py has the loosely-typed default_value: Optional[Any] worth a second look if the API spec narrows the type.

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant C as Client (sync/async)
    participant FF as FeatureFlags module
    participant H as HTTPClient
    participant API as WorkOS API

    C->>FF: list_feature_flags(limit, before, after, order)
    FF->>H: GET /feature-flags?limit=...
    H->>API: GET /feature-flags
    API-->>H: { data: [...], list_metadata: {...} }
    H-->>FF: response dict
    FF-->>C: FeatureFlagsListResource

    C->>FF: get_feature_flag(slug)
    FF->>H: GET /feature-flags/{slug}
    H->>API: GET /feature-flags/{slug}
    API-->>H: feature flag object
    H-->>FF: response dict
    FF-->>C: FeatureFlag

    C->>FF: enable_feature_flag(slug)
    FF->>H: PUT /feature-flags/{slug}/enable  (body: {})
    H->>API: PUT /feature-flags/{slug}/enable
    API-->>H: updated feature flag
    H-->>FF: response dict
    FF-->>C: FeatureFlag (enabled=true)

    C->>FF: disable_feature_flag(slug)
    FF->>H: PUT /feature-flags/{slug}/disable  (body: {})
    H->>API: PUT /feature-flags/{slug}/disable
    API-->>H: updated feature flag
    H-->>FF: response dict
    FF-->>C: FeatureFlag (enabled=false)

    C->>FF: add_feature_flag_target(slug, resource_id)
    FF->>H: POST /feature-flags/{slug}/targets/{resource_id}  (body: {})
    H->>API: POST /feature-flags/{slug}/targets/{resource_id}
    API-->>H: 200 OK
    H-->>FF: (ignored)
    FF-->>C: None

    C->>FF: remove_feature_flag_target(slug, resource_id)
    FF->>H: DELETE /feature-flags/{slug}/targets/{resource_id}
    H->>API: DELETE /feature-flags/{slug}/targets/{resource_id}
    API-->>H: 200 OK
    H-->>FF: (ignored)
    FF-->>C: None

_{Last reviewed commit: "improve feature flag..."}